home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 2 / CD ACTUAL VOL 2.iso / docs / kernel.13 / readme.cm2 < prev    next >
Encoding:
Text File  |  1995-09-10  |  5.8 KB  |  178 lines
  1. This is the readme file for the driver for the Philips/LMS cdrom drive
  2. cm206 in combination with the cm260 host adapter card. 
  3.  
  4.                 (c) 1995 David A. van Leeuwen
  5.    
  6. Features as of version 0.33
  7. ---------------------------
  8. - Full audio support, that is, both  workman, workbone and cdp work
  9.   now reasonably. Reading TOC still takes some time. xmcd has been
  10.   reported to run successfully. 
  11. - Made auto-probe code a little better, i hope
  12.  
  13. Features as of version 0.28
  14. ---------------------------
  15. - Full speed stransfer rate (300 kB/s).
  16. - Minimum kernel memory usage for buffering (less than 3 kB).
  17. - Multisession support.
  18. - Tray locking.
  19. - Statistcics of driver accessible to the user.
  20. - Module support.
  21. - Auto-probing of adapter card's base port and irq line,
  22.   also configurable at boot time or module load time.
  23.  
  24. Features still lacking
  25. ----------------------
  26. - cm205ms+cm250 support. (I do have cm205ms docs now. I still have to
  27.   study Kai Petzke's cm205 drives to understand the workings of the
  28.   cm250 adapter card. Don't bet on me, write a driver yourself!)
  29.  
  30.  
  31. Decide how you are going to use the driver. There are two
  32. options:
  33.  
  34.    (a) installing the driver as a resident part of the kernel
  35.    (b) compiling the driver as a loadable module
  36.  
  37.    Further, you must decide if you are going to specify the base port
  38.    address and the interrupt request line of the adapter card cm260 as
  39.    boot options for (a), module parameters for (b), use automatic
  40.    probing of these values, or hard-wire your adaptor cards settings
  41.    into the source code. If you don't care, you can choose for
  42.    autoprobing, which is the default. In that case you can move on to
  43.    the next step.
  44.  
  45. Compiling the kernel
  46. --------------------
  47. 1) move to /usr/src/linux and do a 
  48.  
  49.     make config
  50.  
  51.    If you have chosen for option (a), answer yes to CONFIG_CM206 and
  52.    CONFIG_ISO9660_FS.
  53.  
  54.    If you have chosen for option (b), answer yes to CONFIG_MODVERSIONS
  55.    and no (!) to CONFIG_CM206 and CONFIG_ISO9660_FS. 
  56.  
  57. 2) then do a 
  58.     
  59.     make dep; make clean; make zImage; make modules
  60.  
  61. 3) do the usual things to install a new image (backup the old one, run
  62.    `rdev -R zImage 1', copy the new image in place, run lilo).  Might
  63.    be `make zlilo'.
  64.  
  65. Using the driver as a module
  66. ----------------------------
  67. If you will only seldomly use the cd-rom driver, you can choose for
  68. option (b), install as a loadable module. You may have to re-compile
  69. the module when you upgrade the kernel to a new version. Read the file
  70. `README.modules' in /usr/src/linux. To install the module, you use the 
  71. command, as root
  72.  
  73.     insmod /usr/src/linux/modules/cm206.o
  74.  
  75. You can specify the base address on the command line as well as the irq 
  76. line to be used, e.g.
  77.  
  78.     insmod /usr/src/linux/modules/cm206.o cm206=0x300,11
  79.  
  80. The order of base port and irq line don't matter; you may specify only
  81. one, the other will have the value of the compiled-in default.  You
  82. may also have to install the file-system module `iso9660.o', if you
  83. didn't compile that into the kernel. (If you use `tcsh' as shell, you
  84. might consider defining
  85.  
  86.     alias listinstalledmodules 'cat /proc/modules | awk \{print\$1\}'
  87.     complete rmmod        'p/1/`listinstalledmodules`/'
  88.     alias listcompiledmodules '(cd /usr/src/linux/modules; \ls -o *.o)'
  89.     alias insmod        'insmod /usr/src/linux/modules/\!:1 \!:2*'
  90.     complete insmod        'p/1/`listcompiledmodules`/'
  91.  
  92. which makes typing insmod and rmmod somewhat easier.)
  93.  
  94. Using the driver as part of the kernel
  95. --------------------------------------
  96. If you have chosen for option a, you can specify the base-port
  97. address and irq on the lilo boot command line, e.g.:
  98.  
  99.     LILO: linux cm206=0x340,11
  100.  
  101. This assumes that your linux kernel image keyword is `linux'. 
  102. If you may specify either IRQ (3--11) or base port (0x300--0x370),
  103. auto probing is turned off for both settings, thus setting the 
  104. other value to the compiled-in default.
  105.  
  106. If module parameters and LILO config options don't work
  107. -------------------------------------------------------
  108. If autoprobing does not work, you can hard-wire the default values
  109. of the base port address (CM206_BASE) and interrupt request line
  110. (CM206_IRQ) into the file ./include/linux/cm206.h. Change
  111. the defines of CM206_IRQ and CM206_BASE.
  112.  
  113.  
  114.  
  115. Mounting the cdrom
  116. ------------------
  117. 1) Make sure that there is the right device installed in /dev.
  118.  
  119.       mknod /dev/cm206cd b 32 0
  120.  
  121. 2) Make sure there is a mount point, e.g., /cdrom 
  122.  
  123.     mkdir /cdrom
  124.  
  125. 3) mount using a command like this (run as root):
  126.  
  127.     mount -rt iso9660 /dev/cm206cd /cdrom
  128.  
  129. 4) For user-mounts, add a line in /etc/fstab
  130.  
  131.     /dev/cm206cd      /cdrom     iso9660     ro,noauto,user
  132.  
  133.    This will allow users to give the commands
  134.  
  135.     mount /cdrom
  136.     umount /cdrom
  137.  
  138. If things don't work
  139. --------------------
  140.  
  141. - Try to do a `tail /var/adm/messages' to find out if the driver
  142.   said anything about what is going wrong during the initialization.
  143.  
  144. - Try to do a `dd if=/dev/cm206cd | od -tc | less' to read from the
  145.   CD.
  146.  
  147. - Look in the /proc directory to see if `cm206' shows up under
  148.   one of `interrupts', `ioports', `devices' or `modules' (if
  149.   applicable). 
  150.  
  151.  
  152. DISCLAIMER 
  153. ---------- 
  154. I cannot guarantee that this driver works, or that the hardware will
  155. not be harmed, although i consider it most unlikely. 
  156.  
  157. I hope that you'll find this driver in some way useful. 
  158.  
  159.                     David van Leeuwen
  160.                     david@tm.tno.nl
  161.  
  162. Note for Linux CDROM vendors
  163. -----------------------------
  164. You are encouraged to include this driver on your Linux CDROM. If
  165. you do, you might consider sending me a free copy of that cd-rom.
  166. You can contact me through my e-mail address, david@tm.tno.nl. 
  167. If this driver is compiled into a kernel to boot off a cdrom, 
  168. you should actually send me a free copy of that cd-rom. 
  169.  
  170. Copyright
  171. ---------
  172. The copyright of the cm206 driver for Linux is 
  173.  
  174.     (c) 1995 David A. van Leeuwen
  175.  
  176. The driver is released, like most Linux software, under the conditions 
  177. of the GNU general public license.
  178.